home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / othernet / fidonet / sonja121 / sonja.txt < prev   
Text File  |  1995-03-11  |  8KB  |  170 lines
  1.  
  2.                            SONJA
  3.                           =======
  4.  
  5.                      Ein Message-Selector
  6.  
  7.  
  8. Jeder hat sich sicher schon einmal darber ge„rgert, dass man in einer Area 
  9. sehr viele Messages hat, die einem gar nicht interessieren. Bisher war es
  10. immer sehr aufwendig und zeitraubend, diejenigen Messages herauszusuchen,
  11. die man wirklich lesen will.
  12.  
  13. Damit hat es nun ein Ende. Mit dem Programm "SONJA" kann man all diejenigen 
  14. Messages als gel”scht markieren, die man sicher nicht lesen m”chte.
  15.  
  16. Da die Messages nicht wirklich gel”scht werden, ist es jederzeit m”glich, 
  17. sie wieder "zum Leben" zu erwecken. Falls man zwischendurch jedoch einen 
  18. Cruncher ( TIDY_UP, FCRUN, BYTHALON etc. ) verwendet hat, sind die 
  19. markierten Messages natrlich definitiv und unwiederruflich gel”scht.
  20.  
  21. Damit SONJA korrekt arbeitet, sind die vier Dateien SONJA.TTP, SONAJ.CFG, 
  22. AREAS.BBS und BINKLEY.CFG n”tig. Die beiden .CFG Dateien mssen sich ent-
  23. weder im gleichen Directory wie SONJA.TTP befinden oder eine der beiden
  24. Environment-Variablen "MAILER" oder "BINKLEY" enth„lt den Pfad, wo sich
  25. diese beiden Dateien befinden.
  26.  
  27. Aus der Datei BINKLEY.CFG werden nur gerade zwei Zeilen ben”tigt: Dies ist
  28. zum einen der Loglevel (Statement LOGLEVEL), den SONJA benutzen soll. Steht dort
  29. eine 5, so macht SONJA sehr ausfhrliche Meldungen. Bei einer 0 werden
  30. gerade noch die Fehlermeldungen angezeigt.
  31. Der zweite Eintrag, der ausgewertet wird, ist STATUSLOG. In die damit angegebene
  32. Datei werden auf Wunsch alle Bildschirmausgaben mitprotokolliert.
  33.  
  34. Welche Areas bearbeitet werden sollen, und welche Bedingungen dann eine 
  35. Message erfllen muss, um gel”scht zu werden, erf„hrt SONJA aus der Datei 
  36. SONJA.CFG. Diese ist eine einfache Textdatei, welche mit jedem Editor erstellt
  37. werden kann. Der Aufbau dieser Datei ist dabei folgender:
  38.  
  39. Zuerst wird mit "AREA=" angegeben, welche Area bearbeitet werden soll.
  40. Nachdem bekannt ist, welche Area bearbeitet werden soll, folgen die 
  41. Bedingungen. Diese k”nnen in einer UPN (wie die HP Taschenrechner) Technik
  42. miteinander verknpft werden: Jede Bedingung legt einen Wert "TRUE" oder
  43. "FALSE" auf einem Stack ab; ja nach dem, ob die Bedingung zutraf oder nicht.
  44. Neben den Bedingungen gibt es dann aber auch noch Kommandos, welche die
  45. Elemente auf dem Stack manipulieren. Man kann auf diese Art und Weise beliebige
  46. Kombinationen der Bedingungen erreichen.
  47.  
  48. Folgende Bedingungen sind m”glich:
  49.  
  50. TO <String>:
  51. Sofern der Adressat mit <String> bereinstimmt, liefert der Vergleich TRUE.
  52.  
  53. FROM <String>:
  54. Sofern der Absender mit <String> bereinstimmt, liefert der Vergleich TRUE.
  55.  
  56. FOT <String>:
  57. FOT ist eine Abkrzung fr FROM_OR_TO. Dieser Vergleich liefert TRUE
  58. sofern der Absender oder der Adressat mit <String> bereinstimmt.
  59.  
  60. SUBJECT <String>:
  61. Wenn das Subject mit <String> bereinstimmt, liefert der Vergleich TRUE.
  62.  
  63. LESS <Zahl>:
  64. Liefert TRUE, sofern die L„nge der Message kleiner als <Zahl> ist.
  65.  
  66. GREATER <Zahl>:
  67. Liefert TRUE, sofern die L„nge der Message gr”sser als <Zahl> ist.
  68.  
  69. OLDER <Zahl>:
  70. Liefert TRUE, sofern die entsprechende Message schon l„nger als <Zahl>
  71. Tage im eigenen System ist.
  72.  
  73. NEWER <Zahl>:
  74. Liefert TRUE, sofern die entsprechende Msg weniger als <Zahl> Tage 
  75. im eigenen System ist.
  76.  
  77. Bei allen Bedingungen, bei denen ein Vergleichsstring angegeben werden 
  78. muss, kann man fr den String auch Wildcards verwenden. "*" passt dabei auf 
  79. beliebig viele Zeichen, w„hrend "?" auf genau ein Zeichen passt. Zudem wird 
  80. nicht zwischen Gross- und Kleinbuchstaben unterschieden. Weil die einzelnen 
  81. Bedingungen und Kommandos durch nicht alphanumerische Zeichen getrennt 
  82. werden, mssen die Strings in einfache oder doppelte Anfhrungszeichen
  83. ( " bzw. ' ) eingeschlossen werden, falls solche nicht alphanumerische
  84. Zeichen im String vorkommen. Als alphanumerische Zeichen gelten alle Buchstaben
  85. und Ziffern sowie die Zeichen ".", "_", "*" und "?".
  86.  
  87. Fr die Stackmanipulationen stehen die folgenden Kommandos zur Verfgung:
  88.  
  89. OR: Die beiden obersten Stack Elemente werden OR verknpft.
  90. AND: Die beiden obersten Stack Elemente werden AND verknpft.
  91. XOR: Die beiden obersten Stack Elemente werden XOR verknpft.
  92. NOT: Das oberste Stack Element wird negiert.
  93. DUP: Das oberste Stack Element wird dupliziert.
  94. SWAP: Die beiden obersten Elemente werden vertauscht.
  95.  
  96. Kommt in einer Zeile ein Strichpunkt ( ; ) vor, so werden alle Zeichen bis 
  97. zum Ende dieser Zeile ignoriert. Befindet sich der Strichpunkt jedoch 
  98. zwischen zwei Anfhrungszeichen ( " bzw. ' ), so wird er nicht beachtet.
  99.  
  100. Die Liste der Bedingungen wird durch ein "END" abgeschlossen. Zu diesem 
  101. Zeitpunkt muss sich noch genau ein Element auf dem Stack befinden. Ist es 
  102. TRUE, so wird die entsprechende Message als gel”scht markiert.
  103.  
  104. Nach dem "END" kann mit einem "AREA=" eine neue Area angegeben werden.
  105.  
  106. Sollten nun noch Fragen offen sein (was ich sogar schwer annehme) schaut 
  107. man sich am Besten einmal das beiliegende SONJA.CFG an. Sollten
  108. immer noch Fragen offen sein, so wende man sich an den Autor.
  109.  
  110.  
  111. In der Command Line k”nnen folgende Parameter an SONJA bergeben werden:
  112.  
  113. -a Area: Es wird nur gerade die angegebene Area bearbeitet. Alle anderen 
  114. bleiben unberhrt.
  115.  
  116. -c Config: Anstelle der Datei "SONJA.CFG" wird die dem Parameter "-c" 
  117. folgende Datei als Konfigurationsdatei genommen. Ein Pfad kann dabei NICHT 
  118. angegeben werden. Die alternative Datei muss sich also im gleichen Ordner 
  119. wie SONJA.CFG befinden.
  120.  
  121. -d: Direct: Es wird nur gerade die mit "-a" angegebene Area bearbeitet.
  122. Anstatt die Bedingungen jedoch aus der Datei SONJA.CFG zu nehmen, kann
  123. man sie gleich hinter "-d" angeben. Die Angaben "AREA=" und "END" sind
  124. dabei nicht anzugeben. Vorsicht: Weil die Bedingungen aus mehreren einzelnen
  125. W”rtern bestehen, mssen sie in Anfhrungszeichen ( " ) gesetzt werden.
  126. Kommen innerhalb der Bedingungen Texte aus mehreren W”rtern vor (z.B.
  127. Vorname Name), so sind diese in einfache Anfhrungszeichen ( ' ) zu setzen.
  128.  
  129. -e: Every: Jede Message der in der Konfigurationsdatei angebenen Areas wird 
  130. bearbeitet. Das heisst, bei jeder Message wird das KILLED-Flag gesetzt, 
  131. gel”scht oder invertiert; unabh„ngig davon, ob die Bedingungen zutreffen 
  132. oder nicht.
  133.  
  134. -h: Help: Es erscheint eine kleine Hilfe.
  135.  
  136. -i: Invert: Bei allen Messages, auf die die Bedingungen zutreffen, wird das 
  137. KILLED Flag invertiert anstatt gesetzt.
  138.  
  139. -l #: Der Loglevel wird auf # gesetzt. Standardm„ssig wird der Loglevel aus 
  140. BINKLEY.CFG genommen. Bei 5 werden viele Ausgaben gemacht, bei 0 kommen nur 
  141. noch die Fehlermeldungen (if any).
  142.  
  143. -r: Rekill: Bei allen Messages, auf die die Bedingungen zutreffen, wird das 
  144. KILLED Flag gel”scht. So kann man in einem ersten Druchlauf gel”schte 
  145. Messages wieder "entl”schen".
  146.  
  147. -s: StatusLog. Alle Bildschirmausgaben werden zus„tzlich in das LogFile
  148. (StatusLog in BINKLEY.CFG) protokolliert. Als Krzel wird SNJA verwendet.
  149.  
  150. -w: Wait: SONJA wartet am Schluss auf einen Tastendruck.
  151.  
  152. SONJA ist Public Domain. Spenden sind jedoch jederzeit willkommen.
  153. Sollten sie kein Geld brig habe, so bin ich auch schon mit einer
  154. Postkarte oder „hnlichem zufrieden.
  155.  
  156. Sofern sie immer das Programm UND diese Dokumentation kopieren, k”nnen
  157. sie es allen interessierten Personen weitergeben. Dies soll jedoch
  158. ohne Profit von statten gehen.
  159.  
  160.  
  161. SONJA ist ein Programm von
  162.  
  163. Markus Bubendorf
  164. Kirchgasse 3
  165. CH-4124 Sch”nenbuch
  166. Tel.:+41 61 482 02 20
  167. E-Mail: 2:301/212.25 @ FidoNet
  168. oder    markus.bubendorf@zrh1.siemens-albis.scn.inet.ch
  169.  
  170.